home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / 4dos / 4utilsf.zip / 4UTILS.DOC < prev    next >
Text File  |  1992-12-10  |  19KB  |  602 lines
  1.                                                                  22Nov92
  2.  
  3.                   4      U   U TTTTT I L     SSSSS
  4.                   4  4   U   U   T   I L     S
  5.                   4  4   U   U   T   I L     S
  6.                   4  4   U   U   T   I L      SSS
  7.                   44444  U   U   T   I L         S
  8.                      4   U   U   T   I L         S
  9.                      4   U   U   T   I L         S
  10.                      4   UUUUU   T   I LLLLL SSSSS
  11.  
  12.                  4UTILS - A small 4DOS Utility Collection
  13.  
  14.        Code created using Turbo Pascal 6.0 (c) Borland International 1990
  15.  
  16.  
  17.        Note: This document has been formatted and is ready for printing.
  18.              (60 lines per page, up to 75 characters per line.)
  19.  
  20.  
  21.  
  22.                  Table of contents:
  23.                  ──────────────────
  24.  
  25.  
  26.          0.   Legal Status, Warranty ............................... 2
  27.          1.   Distribution Policy .................................. 2
  28.          2.   Introduction ......................................... 3
  29.          3.   Getting started ...................................... 4
  30.          4.   4DESC - a simple 4DOS-description editor ............. 5
  31.           4.1  Command line switches and parameters ................ 5
  32.           4.2  Editing and changing descriptions ................... 5
  33.          5.   4FF   - a simple file finder ......................... 6
  34.           5.1  Command line switches and parameters ................ 6
  35.          6.   Customizing 4DESC and 4FF - the 4TOOLS.INI file ...... 8
  36.          7.   How to reach the authors..............................10
  37.          8.   (Re)Compiling 4DESC or 4FF............................11
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.            4UTILS - A small 4DOS Utility Collection              Page 1
  61.  
  62.  
  63.  0. Legal Status, Warranty
  64.  ─────────────────────────────────────────────────────────────────────────
  65.  
  66.  ╔══════════════════════════════════════════════════════════════════════╗
  67.  ║                                                                      ║
  68.  ║ Because 4UTILS is licensed free of charge, the authors, David Frey   ║
  69.  ║ and Tom Bowden, provide absolutely no warranty of any kind, either   ║
  70.  ║ expressed or implied, including, but not limited to, the implied     ║
  71.  ║ warranties of fitness for a particular purpose.                      ║
  72.  ║                                                                      ║
  73.  ║ 4UTILS is provided "as is"; the entire risk as to the quality and    ║
  74.  ║ performance of the program is with you. Should the program prove     ║
  75.  ║ defective, you assume the cost of all necessary servicing, repair    ║
  76.  ║ or correction.                                                       ║
  77.  ║                                                                      ║
  78.  ║ In no event will any copyright holder, or any other party who may    ║
  79.  ║ modify and/or redistribute the program as permitted below, be liable ║
  80.  ║ to you for damages, including any general, special, incidental       ║
  81.  ║ or consequential damages arising out of the use or inability to use  ║
  82.  ║ the program (including but not limited to loss of data or data being ║
  83.  ║ rendered inaccurate or losses sustained by you or third parties or a ║
  84.  ║ failure of the program to operate with any other programs), even if  ║
  85.  ║ such holder or other party has been advised of the possibility of    ║
  86.  ║ such damages.                                                        ║
  87.  ║                                                                      ║
  88.  ╚══════════════════════════════════════════════════════════════════════╝
  89.  
  90.  These programs are freeware: you are allowed to use, copy and change them
  91.  free of charge, when the following conditions are met:
  92.  
  93.  * 4DESC or 4FF may not be sold or hired.
  94.  
  95.  * Never change copyright statements: the copyright remains in our hands.
  96.  
  97.  * If you make any (considerable) changes to the source code, please let
  98.    us know (send us a copy or a listing). We would like to see what you
  99.    have done.
  100.  
  101.  
  102.  1. Distribution Policy
  103.  ────────────────────────────────────────────────────────────────────────
  104.  
  105.  You can distribute these utilities under the following conditions:
  106.  
  107.  * You ask no contribution from the receiver of this package except
  108.    from a nominal copying charge not to exceed US $6. (SFr. 10).
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.            4UTILS - A small 4DOS Utility Collection              Page 2
  121.  
  122.  
  123.  * This archive must be left intact. (repacking allowed). That means the
  124.    receiver of this package must receive the following files:
  125.  
  126.    Archive:  4utilsf.zip   96085 bytes   18 files
  127.    ,,rw,       1.1 dos   26480 b- i8:2 10-Dec-92 01:32 4DESC.EXE
  128.    ,,rw,       1.1 dos   28685 b- i8:3 10-Dec-92 01:32 4DESC.PAS
  129.    ,,rw,       1.1 dos    1176 b- i4:3 10-Dec-92 01:30 4DESC.TXT
  130.    ,,rw,       1.1 dos   26848 b- i8:2 10-Dec-92 01:32 4DESC86.EXE
  131.    ,,rw,       1.1 dos   28480 b- i8:2 10-Dec-92 01:51 4FF.EXE
  132.    ,,rw,       1.1 dos   13577 b- i8:3 10-Dec-92 01:51 4FF.PAS
  133.    ,,rw,       1.1 dos   28656 b- i8:2 10-Dec-92 01:51 4FF86.EXE
  134.    ,,rw,       1.1 dos    1827 b- i4:3 10-Dec-92 01:32 4TOOLS.SMP
  135.    ,,rw,       1.1 dos   18976 b- i8:3 10-Dec-92 01:51 4UTILS.DOC
  136.    ,,rw,       1.1 dos    1409 b- i4:2 10-Dec-92 01:51 DESC.BTM
  137.    ,,rw,       1.1 dos   10687 b- i8:3 10-Dec-92 01:32 DISPLAYK.PAS
  138.    ,,rw,       1.1 dos     269 b- shrk 10-Dec-92 01:51 FILE_ID.DIZ
  139.    ,,rw,       1.1 dos    4080 b- i4:3 10-Dec-92 01:51 GLOBALS.PAS
  140.    ,,rw,       1.1 dos    5691 b- i8:3 10-Dec-92 01:30 HANDLEIN.PAS
  141.    ,,rw,       1.1 dos    6487 b- i8:3 10-Dec-92 01:51 SCANLZHF.PAS
  142.    ,,rw,       1.1 dos    8162 b- i8:3 10-Dec-92 01:51 SCANZIPF.PAS
  143.    ,,rw,       1.1 dos   13544 b- i8:3 10-Dec-92 01:30 STRINGDA.PAS
  144.    ,,rw,       1.1 dos    1160 b- i4:3 10-Dec-92 01:51 PACKING.LST
  145.    18 files, 226194 bytes uncompressed, 94331 bytes compressed:  58%
  146.  
  147.  
  148.  
  149.  2. Introduction
  150.  ─────────────────────────────────────────────────────────────────────────
  151.  
  152.  4UTILS is a small collection of 4DOS *) utilities. I have created
  153.  them for my needs and I'm releasing them as freeware.
  154.  
  155.  *) 4DOS is a trademark of JP Software Inc,
  156.                            PO Box 1470
  157.                            E. Arlington
  158.                            MA 02174
  159.                            USA
  160.  
  161.  I'm a happy (and registered) user of 4DOS and I could not return to plain
  162.  COMMAND.COM. In course of time I began to write tools which were aware of
  163.  an important 4DOS feature: file descriptions.
  164.  
  165.  These file descriptions are very handy; when I was searching some files
  166.  (with  `FF read.me' for example) I've often missed them. So I decided to
  167.  write a 4DOS aware file finder.
  168.  
  169.  Then, I wrote 4DESC because 4DOS's `describe' is not able of cutting and
  170.  pasting. I need this feature, since I'm programming:
  171.  
  172.   The programs and their corresponding source code often get similar
  173.   descriptions. Getting bored of retyping similar descriptions I've wrote
  174.   4DESC.
  175.  
  176.  
  177.  
  178.  
  179.  
  180.            4UTILS - A small 4DOS Utility Collection              Page 3
  181.  
  182.  
  183.  3. Getting started
  184.  ─────────────────────────────────────────────────────────────────────────
  185.  
  186.  Installing 4UTILS is simple. Do the following:
  187.  (In this example I assume you install the 4UTILS package in C:\4TOOLS;
  188.   please change directory name if this does not apply.)
  189.  
  190.      i) create a new directory where 4UTILS should reside,
  191.         and change into it:
  192.  
  193.          CDD C:\
  194.          MKDIR 4TOOLS (or MD 4TOOLS)
  195.          CD 4TOOLS
  196.  
  197.     ii) unzip the contents of 4UTILSx.ZIP:
  198.  
  199.          UNZIP C:\TEMP\4UTILSx.ZIP
  200.  
  201.          ^^^^  ^^^^^^^^      ^
  202.          |     |             |
  203.          |     |             The newest version of 4UTILS. The version
  204.          |     |             number is coded in the last letter,
  205.          |     |             e.g. 4UTILSE.ZIP
  206.          |     |
  207.          |     The directory you downloaded 4UTILSx.ZIP
  208.          |
  209.          UNZIP is the unzipper you use. You can either use UNZIP from
  210.          the InfoZip Group (free) or original PKUNZIP.
  211.  
  212.  
  213.    iii) Append the directory 4TOOLS to your path.
  214.  
  215.         ESET PATH
  216.         Press <End> and type ';C:\4TOOLS'
  217.  
  218.         or
  219.  
  220.         SET path=%path%;C:\4TOOLS
  221.  
  222.  
  223.     iv) Run DESC-ME.BTM to describe your newly extracted files.
  224.  
  225.      v) Adapt (or create) a suitable 4TOOLS.INI file, if needed.
  226.         (see section `Customizing')
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.            4UTILS - A small 4DOS Utility Collection              Page 4
  241.  
  242.  
  243.  4.   4DESC - a simple 4DOS-description editor
  244.  ─────────────────────────────────────────────────────────────────────────
  245.  
  246.  4.1  Command line switches and parameters
  247.  ─────────────────────────────────────────
  248.  
  249.  Syntax of 4DESC is : 4DESC [/help] [/mono] [d:][\path\][descript.ion]
  250.  
  251.  There are two command line switches:
  252.  
  253.  /help switches directly into the help screen, pressing a key leads
  254.        into description edit mode.
  255.  
  256.  /mono 4DESC automatically detects on startup whether you are using a
  257.        monochrome or a color monitor. This switch is intended to override
  258.        the detection and to switch directly into monochrome mode.
  259.        (useful on EGA/VGA displays only).
  260.  
  261.  When supplying a path specification, 4DESC will read the description file
  262.  residing in the path you have specified.
  263.  
  264.  NOTE: The trailing backslash _is_ necessary.
  265.  
  266.  
  267.  4.2  Editing and changing descriptions
  268.  ──────────────────────────────────────
  269.  
  270.  The following keys have special meanings:
  271.  
  272.  UpArr, DnArr, PgUp, PgDn: Move highlight bar (trivial)
  273.  LtArr, RtArr, Home, End : Move cursor        (   "   )
  274.  
  275.  Ctrl-PgUp, Ctrl-PgDn    : Move to first or last line
  276.  
  277.  Backspace               : Delete the character before the cursor
  278.  DEL                     : Delete the character under  the cursor
  279.  Ctrl-End                : Delete from cursor to end of line
  280.  INS                     : Toggle from insert mode  to overwrite mode.
  281.                            After startup 4DESC works in insert mode.
  282.  
  283.  Alt-D                   : Delete current description 1)
  284.  Alt-C                   : Copy current description to buffer 1) 2)
  285.  Alt-M or Alt-T          : Move current description to buffer 1) 2)
  286.  Alt-P                   : Paste buffer to current description 1)
  287.  Alt-V or F3             : View highlighted file
  288.  Alt-X or ESC            : Exits 4DESC
  289.  
  290.  F4 or ENTER on dir      : Change to highlighted directory
  291.  F5 or ENTER on ..       : Change to parent directory
  292.  F6 or Alt-L             : Change drive
  293.  
  294.  F2 or F10               : saves your descriptions.
  295.  F1                      : show help screen
  296.  
  297.  1) A "Edit" flag will appear on the bottom right side of the screen
  298.  2) " "Cut"    "    "    "    "   "     "     "    "   "   "     "
  299.  
  300.            4UTILS - A small 4DOS Utility Collection              Page 5
  301.  
  302.  
  303.  If you have edited some descriptions, but not saved, a "Edit" flag
  304.  will appear to remind you of having altered your descriptions.
  305.  
  306.  Remark: When changing current directory/drive a question
  307.  
  308.          "Descriptions have been edited. Shall they be saved (Y/N) ?"
  309.  
  310.          will appear; therefore you need not to worry about your
  311.          description's actuality.
  312.  
  313.  
  314.  
  315.  5.   4FF   - a simple file finder
  316.  ─────────────────────────────────────────────────────────────────────────
  317.  
  318.  5.1  Command line switches and parameters
  319.  ─────────────────────────────────────────
  320.  
  321.  Syntax of 4FF is:
  322.  
  323.  4FF [/a:[[+|]-]rash][/l][/z][/s][/b][/d][/n][/?] [start dir] {filenames}
  324.  
  325.  This time there is a bunch of command line switches, but they are rather
  326.  simple.
  327.  
  328.  /a     followed by a combination of
  329.          r (read only),  -r (not read only)
  330.          a (archive)  ,  -a (not archived)
  331.          s (system)   or -s (not system)
  332.          h (hidden)      -h (not hidden)
  333.  
  334.         searches for files which have these attributes set resp. reset.
  335.  
  336.         Examples:
  337.  
  338.         . 4ff /a:-r *.exe *.com
  339.           searches for executable, writable files.
  340.  
  341.         . 4ff /a:a *.*
  342.           searches for files which have not been backuped yet.
  343.  
  344.  /l     do not search in .lzh archive files.
  345.  /z     do not search in .zip archive files.
  346.  
  347.         By default 4FF searches in .lzh and .zip archives too,
  348.         by using /l or /z  4FF will speed up.
  349.  
  350.         Example: 4FF /z /l *.bak
  351.  
  352.         Searching for *.bak files in archives is not very intelligent !
  353.  
  354.  /s     scan only subdirectories of given path `start-dir'
  355.  
  356.         4FF will begin scanning the subdirectory you specified in start dir
  357.         and will recurse to the deeper levels. This will speed your search
  358.         up, if you roughly know where your files reside.
  359.  
  360.            4UTILS - A small 4DOS Utility Collection              Page 6
  361.  
  362.  
  363.  /b     bare listing (omits size, date, and descriptions)
  364.  
  365.         This switch is intended for producing "bare" file listing (file
  366.         names only) for batch files.
  367.  
  368.  /d     scan all hard disks (floppy drives not included)
  369.  
  370.         Example: 4FF /d *.bak *.swp *.tmp
  371.  
  372.         Locates backup, swap and temporary files, which generally may be
  373.         deleted before backuping your hard disk.
  374.  
  375.         Remark: Floppy drives must be addressed explicitly.
  376.                 Otherwise (if 4FF would scan all drives from A to Z)
  377.                 you had to insert floppy disks into your drives, even
  378.                 if you would't be interested in their contents.
  379.  
  380.            4UTILS - A small 4DOS Utility Collection              Page 6
  381.  
  382.  
  383.  /m:nn  set right margin to nn.
  384.         When printing direct to your line printer, you can set the printer
  385.         width by this switch.
  386.  
  387.         Example: 4FF /m:132 *.pas > prn:
  388.  
  389.         [Note: Putting your printer in 132 column mode is your duty!]
  390.  
  391.         NOTE: If you are a lucky owner of a e.g. 132 column mode VGA card
  392.               (everything above 80 characters) you will use this switch
  393.               too; 4FF's internal default screen width is 80 characters.
  394.  
  395.  /?     this help display.
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.            4UTILS - A small 4DOS Utility Collection              Page 7
  421.  
  422.  
  423.  6.   Customizing 4DESC and 4FF - the 4TOOLS.INI file
  424.  ─────────────────────────────────────────────────────────────────────────
  425.  
  426.  This section is only for people interested in customizing 4FF or 4DESC.
  427.  You need not to worry about all the options described below if you "just"
  428.  want to use 4FF / 4DESC and if you are happy with the country settings
  429.  and the colors.
  430.  
  431.  If you are familiar with the SSTOOLS.INI file (I mean: I you are a
  432.  FRACTINT or PICLAB user) or if the WIN.INI or 4DOS.INI has already been
  433.  changed by you, you shouldn't have problems with the 4TOOLS.INI file too.
  434.  
  435.  A 4TOOLS.INI file consists of several sections, enclosed in square
  436.  brackets ([ and ]).
  437.  
  438.  Remark: The following examples have been taken out of 4TOOLS.SMP - a
  439.          sample 4TOOLS.INI file.
  440.  
  441.  [Date & Time formats]
  442.  
  443.  The following entries are possible:
  444.  
  445.  DateFormat = mmddyy |  ddmmyy | yymmdd | ddMMMyy
  446.               7.10.92, 10-07-92, 92/10/7,  7Oct92.
  447.  
  448.  DateSep   = -
  449.  
  450.  Date separator is a hyphen (mm-dd-yy)
  451.  
  452.  TimeFormat= 12
  453.  
  454.  valid entries are: 12 (am/pm) or 24 (24 hours).
  455.  
  456.  TimeSep   = :
  457.  
  458.  Time separator is a colon  (hh:mm). Fill in what you like.
  459.  
  460.  MilleSep  = '
  461.  
  462.  Fill in what you like for the thousands separator.
  463.  
  464.  NOTE: 4DESC / 4FF detect on startup where you live. (provided that
  465.        your COUNTRY= settings in CONFIG.SYS has been properly set.
  466.        The switches above are merely cosmetic.
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.            4UTILS - A small 4DOS Utility Collection              Page 8
  481.  
  482.  
  483.  [ColorDisplay]
  484.  
  485.  That is the place where you may change the colors!
  486.  The following colors are available (case not significant)
  487.  
  488.   Black    , DarkGray
  489.   Blue     , LightBlue
  490.   Green    , LightGreen
  491.   Cyan     , LightCyan
  492.   Red      , LightRed
  493.   Magenta  , LightMagenta
  494.   Brown    , Yellow
  495.   LightGray, White
  496.  
  497.  StatusFg = Blue         ; Status line foreground color
  498.  StatusBg = Cyan         ;   "      "  background   "
  499.  DirFg    = LightBlue    ; Directories are shown in DirFg on NormBg
  500.  SelectFg = Blue         ; Select bar foreground color
  501.  SelectBg = Cyan         ;   "     "  background   "
  502.  HighFg   = LightRed     ; Highlighted foreground,
  503.                            used for * and () marks
  504.  NormFg   = LightGray    ; normal foreground color
  505.  NormBg   = Blue         ;   "    background   "
  506.  WarnFg   = Yellow       ; foreground for warning messages.
  507.  WarnBg   = Cyan         ; background  "     "       "
  508.  
  509.  [MonoDisplay]
  510.  
  511.  The same for monochrome displays...
  512.  
  513.  StatusFg = Black
  514.  StatusBg = LightGray
  515.  DirFg    = White
  516.  SelectFg = Black
  517.  SelectBg = LightGray
  518.  HighFg   = LightGray;
  519.  NormFg   = LightGray
  520.  NormBg   = Black
  521.  WarnFg   = Black
  522.  WarnBg   = White
  523.  
  524.  
  525.  [GeneralDisplay]
  526.  
  527.  LeftJust = Yes | No | Y | N
  528.  
  529.  If you want the filenames justified to left side (xxxxxx  .xxx) set
  530.  LeftJust = Y, otherwise they are justified in the "normal" way
  531.  (xxxxxx   .xxx).
  532.  
  533.  FullSize = Yes | No | Y | N
  534.  
  535.  Set FullSize=Y to get the `full' size display (x'xxx'xxx [Bytes]) instead
  536.  of  (xxxK).
  537.  
  538.  
  539.  
  540.            4UTILS - A small 4DOS Utility Collection              Page 9
  541.  
  542.  7. How to reach the authors
  543.  ─────────────────────────────────────────────────────────────────────────
  544.  
  545.  Our addresses are:
  546.  
  547.  David Frey,               &   Tom Bowden
  548.  Urdorferstrasse 30            1575 Canberra Drive
  549.  8952 Schlieren ZH             Stone Mountain, GA 30088-3629
  550.  Switzerland                   USA
  551.  
  552.  eMail:                        eMail:
  553.  
  554.  frey@ezinfo.vsmail.ethz.ch    73247.3571@compuserve.com
  555.  
  556.  P.S: We are just curious how far this package will be spread, so could
  557.       you drop an eMail message, please ?
  558.       [That's not mandatory, of course.]
  559.  
  560.  
  561.  8. (Re)Compiling 4DESC or 4FF
  562.  ─────────────────────────────────────────────────────────────────────────
  563.  
  564.  Some hints about (re)compiling 4DESC or 4FF:
  565.  (Recompiling 4DESC might be useful, in order to change the default colors)
  566.  
  567.  . 4DESC and 4FF have been written in Turbo Pascal 6.0
  568.  . They use the features Turbo Pascal 6.0 provides, i.e.
  569.  
  570.    * Inline Assembling ( ASM ... END )
  571.  
  572.      If you don't have an inline assembler, recode the parts containing
  573.      ASM-statements.
  574.  
  575.  
  576.    * 4FF uses the FormatStr-procedures, that implies the following:
  577.  
  578.      Although 4FF isn't object-oriented at all, it uses the Objects and the
  579.      Drivers-Unit shipped with Turbo Pascal 6.0 (Reason: The FormatStr
  580.      procedure is hidden in the Drivers unit, which needs the Object in
  581.      order to work :-( ).
  582.  
  583.      If you neither have OBJECTS.TPU, nor DRIVERS.TPU you are urged to re-
  584.      write the screen output of 4FF.
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.             4UTILS - A small 4DOS Utility Collection              Page 10
  601.  
  602.